RETURN_TEMPLATE

SoftwareShield Web-Activator > Web-Activator Communication > Web-Activator Configuration File Specifiers > RETURN_TEMPLATE

## RETURN_TEMPLATE

You should already have a good understanding of Web-Activator Communication and Web-Activator Configuration File Usage.

The RETURN_TEMPLATE parameter specifies either a file name (with relative path info) or a literal string. It is used to assemble an Activation Code with prefix and suffix strings before returning the entire value to the caller.

###### Behaviour:

- First, the specified string is checked to see if it represents a valid file name on the server (must be specified as a relative path from the Web-Activator). If it is a valid file, the contents of that file are used as the return template. The file must be in ASCII text (such as an HTML file).
  If it does not represent a file, the literal string specified is used as the return template. Template strings specified in this way may not span more than one line in the config file - but may be of any length.
  Either way, the return template itself must contain at least one instance of the following special tag: "<#ACTCODE>" The template will be returned to the caller of the Web-Activator and all instances of the "<#ACTCODE>" tag will be replaced by the Activation Code generated.
  Note that if an error occurs, the error message will be returned in place of the "<#ACTCODE>" tags, so it is best to keep your template as brief as possible and use only one "<#ACTCODE>" tag. If the "<#ACTCODE>" tag is not present - the default template is used.

###### Allowable Values:

- Any existing valid template file name on the server. To be valid, the template file must contain at least one instance of the string "<#ACTCODE>". A relative path may be included. If relative path information is not included, the template file must be in the same directory as the Web-Activator.

- Any valid literal string. To be valid, it must contain at least one copy of the string "<#ACTCODE>".

###### Default:

- <softshop><#ACTCODE></softshop>

###### Examples:

- RETURN_TEMPLATE=mydir\template1.htm

- RETURN_TEMPLATE=<H1>Your Activation Code:<br><#ACTCODE></H1>